home *** CD-ROM | disk | FTP | other *** search
/ Skunkware 5 / Skunkware 5.iso / man / cat.1 / groff.1 < prev    next >
Text File  |  1995-07-25  |  13KB  |  265 lines

  1.  
  2.  
  3.  
  4.      GGGGRRRROOOOFFFFFFFF((((1111))))      GGGGrrrrooooffffffff VVVVeeeerrrrssssiiiioooonnnn 1111....00009999 ((((22224444 FFFFeeeebbbbrrrruuuuaaaarrrryyyy 1111999999994444))))      GGGGRRRROOOOFFFFFFFF((((1111))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           groff - front end for the groff document formatting system
  10.  
  11.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.           ggggrrrrooooffffffff [ ----ttttppppeeeesssszzzzaaaaiiiivvvvhhhhbbbbllllCCCCEEEENNNNRRRRVVVVXXXXZZZZ ] [ ----wwww_n_a_m_e ] [ ----WWWW_n_a_m_e ] [ ----mmmm_n_a_m_e
  13.           ] [ ----FFFF_d_i_r ] [ ----TTTT_d_e_v ] [ ----ffff_f_a_m ] [ ----MMMM_d_i_r ] [ ----dddd_c_s ] [ ----rrrr_c_n ]
  14.           [ ----nnnn_n_u_m ] [ ----oooo_l_i_s_t ] [ ----PPPP_a_r_g ] [ _f_i_l_e_s... ]
  15.  
  16.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  17.           ggggrrrrooooffffffff is a front-end to the groff document formatting
  18.           system.  Normally it runs the ggggttttrrrrooooffffffff program and a
  19.           postprocessor appropriate for the selected device.
  20.           Available devices are:
  21.  
  22.           ppppssss   For PostScript printers and previewers
  23.  
  24.           ddddvvvviiii  For TeX dvi format
  25.  
  26.           XXXX77775555  For a 75 dpi X11 previewer
  27.  
  28.           XXXX111100000000 For a 100dpi X11 previewer
  29.  
  30.           aaaasssscccciiiiiiii
  31.                For typewriter-like devices
  32.  
  33.           llllaaaattttiiiinnnn1111
  34.                For typewriter-like devices using the ISO Latin-1
  35.                character set.
  36.  
  37.           The postprocessor to be used for a device is specified by
  38.           the ppppoooossssttttpppprrrroooo command in the device description file.  This
  39.           can be overridden with the ----XXXX option.
  40.  
  41.           The default device is ppppssss.  It can optionally preprocess with
  42.           any of ggggppppiiiicccc, ggggeeeeqqqqnnnn, ggggttttbbbbllll, ggggrrrreeeeffffeeeerrrr, or ggggssssooooeeeelllliiiimmmm....
  43.  
  44.           Options without an argument can be grouped behind a single
  45.           ----.  A filename of ---- denotes the standard input.
  46.  
  47.           The ggggrrrroooogggg command can be used to guess the correct groff
  48.           command to use to format a file.
  49.  
  50.      OOOOPPPPTTTTIIIIOOOONNNNSSSS
  51.           ----hhhh   Print a help message.
  52.  
  53.           ----eeee   Preprocess with geqn.
  54.  
  55.           ----tttt   Preprocess with gtbl.
  56.  
  57.           ----pppp   Preprocess with gpic.
  58.  
  59.           ----ssss   Preprocess with gsoelim.
  60.  
  61.  
  62.  
  63.      Page 1                                           (printed 3/9/94)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      GGGGRRRROOOOFFFFFFFF((((1111))))      GGGGrrrrooooffffffff VVVVeeeerrrrssssiiiioooonnnn 1111....00009999 ((((22224444 FFFFeeeebbbbrrrruuuuaaaarrrryyyy 1111999999994444))))      GGGGRRRROOOOFFFFFFFF((((1111))))
  71.  
  72.  
  73.  
  74.           ----RRRR   Preprocess with grefer.  No mechanism is provided for
  75.                passing arguments to ggggrrrreeeeffffeeeerrrr because most grefer options
  76.                have equivalent commands which can be included in the
  77.                file.  See ggggrrrreeeeffffeeeerrrr(1) for more details.
  78.  
  79.           ----vvvv   Make programs run by ggggrrrrooooffffffff print out their version
  80.                number.
  81.  
  82.           ----VVVV   Print the pipeline on stdout instead of executing it.
  83.  
  84.           ----zzzz   Suppress output from ggggttttrrrrooooffffffff.  Only error messages will
  85.                be printed.
  86.  
  87.           ----ZZZZ   Do not postprocess the output of ggggttttrrrrooooffffffff.  Normally
  88.                ggggrrrrooooffffffff will automatically run the appropriate
  89.                postprocessor.
  90.  
  91.           ----PPPP_a_r_g
  92.                Pass _a_r_g to the postprocessor.  Each argument should be
  93.                passed with a separate ----PPPP option.  Note that ggggrrrrooooffffffff does
  94.                not prepend ---- to _a_r_g before passing it to the
  95.                postprocessor.
  96.  
  97.           ----llll   Send the output to a printer.  The command used for
  98.                this is specified by the pppprrrriiiinnnntttt command in the device
  99.                description file.
  100.  
  101.           ----LLLL_a_r_g
  102.                Pass _a_r_g to the spooler.  Each argument should be
  103.                passed with a separate ----LLLL option.  Note that ggggrrrrooooffffffff does
  104.                not prepend ---- to _a_r_g before passing it to the
  105.                postprocessor.
  106.  
  107.           ----TTTT_d_e_v
  108.                Prepare output for device _d_e_v.  The default device is
  109.                ppppssss.
  110.  
  111.           ----XXXX   Preview with ggggxxxxddddiiiittttvvvviiiieeeewwww instead of using the usual
  112.                postprocessor.  This is unlikely to produce good
  113.                results except with ----TTTTppppssss.
  114.  
  115.           ----NNNN   Don't allow newlines with eqn delimiters.  This is the
  116.                same as the ----NNNN option in ggggeeeeqqqqnnnn.
  117.  
  118.           ----aaaa
  119.           ----bbbb
  120.           ----iiii
  121.           ----CCCC
  122.           ----EEEE
  123.           ----wwww_n_a_m_e
  124.           ----WWWW_n_a_m_e
  125.           ----mmmm_n_a_m_e
  126.  
  127.  
  128.  
  129.      Page 2                                           (printed 3/9/94)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      GGGGRRRROOOOFFFFFFFF((((1111))))      GGGGrrrrooooffffffff VVVVeeeerrrrssssiiiioooonnnn 1111....00009999 ((((22224444 FFFFeeeebbbbrrrruuuuaaaarrrryyyy 1111999999994444))))      GGGGRRRROOOOFFFFFFFF((((1111))))
  137.  
  138.  
  139.  
  140.           ----oooo_l_i_s_t
  141.           ----dddd_c_s
  142.           ----rrrr_c_n
  143.           ----FFFF_d_i_r
  144.           ----MMMM_d_i_r
  145.           ----ffff_f_a_m
  146.           ----nnnn_n_u_m
  147.                These are as described in ggggttttrrrrooooffffffff(1)....
  148.  
  149.      EEEENNNNVVVVIIIIRRRROOOONNNNMMMMEEEENNNNTTTT
  150.           GGGGRRRROOOOFFFFFFFF____CCCCOOOOMMMMMMMMAAAANNNNDDDD____PPPPRRRREEEEFFFFIIIIXXXX
  151.                If this is set _X, then ggggrrrrooooffffffff will run _Xttttrrrrooooffffffff instead of
  152.                ggggttttrrrrooooffffffff.  This also applies to ttttbbbbllll, ppppiiiicccc, eeeeqqqqnnnn, rrrreeeeffffeeeerrrr and
  153.                ssssooooeeeelllliiiimmmm.  It does not apply to ggggrrrrooooppppssss, ggggrrrrooooddddvvvviiii, ggggrrrroooottttttttyyyy and
  154.                ggggxxxxddddiiiittttvvvviiiieeeewwww.
  155.  
  156.           GGGGRRRROOOOFFFFFFFF____TTTTMMMMAAAACCCC____PPPPAAAATTTTHHHH
  157.                A colon separated list of directories in which to
  158.                search for macro files.
  159.  
  160.           GGGGRRRROOOOFFFFFFFF____TTTTYYYYPPPPEEEESSSSEEEETTTTTTTTEEEERRRR
  161.                Default device.
  162.  
  163.           GGGGRRRROOOOFFFFFFFF____FFFFOOOONNNNTTTT____PPPPAAAATTTTHHHH
  164.                A colon separated list of directories in which to
  165.                search for the ddddeeeevvvv_n_a_m_e directory.
  166.  
  167.           PPPPAAAATTTTHHHH The search path for commands executed by ggggrrrrooooffffffff.
  168.  
  169.           GGGGRRRROOOOFFFFFFFF____TTTTMMMMPPPPDDDDIIIIRRRR
  170.                The directory in which temporary files will be created.
  171.                If this is not set and TTTTMMMMPPPPDDDDIIIIRRRR is set, temporary files
  172.                will be created in that directory.  Otherwise temporary
  173.                files will be created in ////ttttmmmmpppp.  The ggggrrrrooooppppssss(1) and
  174.                ggggrrrreeeeffffeeeerrrr(1) commands can create temporary files.
  175.  
  176.      FFFFIIIILLLLEEEESSSS
  177.           ////uuuussssrrrr////llllooooccccaaaallll////lllliiiibbbb////ggggrrrrooooffffffff////ffffoooonnnntttt////ddddeeeevvvv_n_a_m_e////DDDDEEEESSSSCCCC
  178.                Device description file for device _n_a_m_e.
  179.  
  180.           ////uuuussssrrrr////llllooooccccaaaallll////lllliiiibbbb////ggggrrrrooooffffffff////ffffoooonnnntttt////ddddeeeevvvv_n_a_m_e////_F
  181.                Font file for font _F of device _n_a_m_e.
  182.  
  183.      AAAAUUUUTTTTHHHHOOOORRRR
  184.           James Clark <jjc@jclark.com>
  185.  
  186.      BBBBUUUUGGGGSSSS
  187.           Report bugs to bug-groff@prep.ai.mit.edu.  Include a
  188.           complete, self-contained example that will allow the bug to
  189.           be reproduced, and say which version of groff you are using.
  190.  
  191.      CCCCOOOOPPPPYYYYRRRRIIIIGGGGHHHHTTTT
  192.  
  193.  
  194.  
  195.      PPPPaaaaggggeeee 3333                                           ((((pppprrrriiiinnnntttteeeedddd 3333////9999////99994444))))
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.      GGGGRRRROOOOFFFFFFFF((((1111))))      GGGGrrrrooooffffffff VVVVeeeerrrrssssiiiioooonnnn 1111....00009999 ((((22224444 FFFFeeeebbbbrrrruuuuaaaarrrryyyy 1111999999994444))))      GGGGRRRROOOOFFFFFFFF((((1111))))
  203.  
  204.  
  205.  
  206.           Copyright c 1989, 1990, 1991, 1992 Free Software Foundation,
  207.           Inc.
  208.  
  209.           groff is free software; you can redistribute it and/or
  210.           modify it under the terms of the GNU General Public License
  211.           as published by the Free Software Foundation; either version
  212.           2, or (at your option) any later version.
  213.  
  214.           groff is distributed in the hope that it will be useful, but
  215.           WITHOUT ANY WARRANTY; without even the implied warranty of
  216.           MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See
  217.           the GNU General Public License for more details.
  218.  
  219.           You should have received a copy of the GNU General Public
  220.           License along with groff; see the file COPYING.  If not,
  221.           write to the Free Software Foundation, 675 Mass Ave,
  222.           Cambridge, MA 02139, USA.
  223.  
  224.      AAAAVVVVAAAAIIIILLLLAAAABBBBIIIILLLLIIIITTTTYYYY
  225.           The most recent released version of groff is always
  226.           available for anonymous ftp from prep.ai.mit.edu
  227.           (18.71.0.38) in the directory pub/gnu.
  228.  
  229.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  230.           ggggrrrroooogggg(1), ggggttttrrrrooooffffffff(1), ggggttttbbbbllll(1), ggggppppiiiicccc(1), ggggeeeeqqqqnnnn(1), ggggssssooooeeeelllliiiimmmm(1),,,,
  231.           ggggrrrreeeeffffeeeerrrr(1), ggggrrrrooooppppssss(1), ggggrrrrooooddddvvvviiii(1), ggggrrrroooottttttttyyyy(1), ggggxxxxddddiiiittttvvvviiiieeeewwww(1),
  232.           ggggrrrrooooffffffff____ffffoooonnnntttt(5), ggggrrrrooooffffffff____oooouuuutttt(5), ggggrrrrooooffffffff____mmmmssss(7), ggggrrrrooooffffffff____mmmmeeee(7),
  233.           ggggrrrrooooffffffff____cccchhhhaaaarrrr(7)
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.      Page 4                                           (printed 3/9/94)
  262.  
  263.  
  264.  
  265.